home *** CD-ROM | disk | FTP | other *** search
/ Ubisoft (Chinese) Press Kit 2000 / PRESSKIT.iso / ubisoft.exe / ubisoft.dxr / 00038_Jump to Marker Button.ls < prev    next >
Encoding:
Text File  |  2000-09-01  |  9.4 KB  |  238 lines
  1. property myMarker, myJumpMode, myReturn
  2. global gNavigationButtonList
  3.  
  4. on getBehaviorDescription me
  5.   return "JUMP TO MARKER BUTTON" & RETURN & RETURN & "A click on the sprite makes the playback head jump to a chosen marker in the same movie. " & "You can choose between the previous marker, the next marker, or any named marker in the movie." & RETURN & RETURN & "If more than one marker has the same name as the chosen marker, the playback head will jump to the first marker with that name in the movie. " & "If you need to use duplicate names, try adding a different number of spaces at the end of each, so that they appear the same but are in fact different." & RETURN & RETURN & "This behavior is designed for use with the Jump Back Button. " & "You can set it to record the frame number of the current marker so that the Jump Back Button can subsequently return. " & "Note: This feature relies on a global variable: gNavigationButtonList." & RETURN & RETURN & "Use the Jump to Movie Button behavior to jump to a marker in a different movie." & RETURN & RETURN & "PERMITTED MEMBER TYPES:" & RETURN & "Graphic members" & RETURN & RETURN & "PARAMETERS:" & RETURN & "* Jump to marker in this movie" & RETURN & "* 'Go to' or 'Play and return'?" & RETURN & "* Remember current marker for Back button" & RETURN & RETURN & "Select Remember Current Marker for Back Button to ensure that the behavior 'remembers' which markers have already been visited." & RETURN & RETURN & "Use the associated Jump Back Button behavior on a separate sprite to return to visited markers in reverse order." & RETURN & RETURN & "ASSOCIATED BEHAVIORS:" & RETURN & "* Jump to Movie button" & RETURN & "* Jump Back Button" & RETURN & "* Jump Forward Button" & RETURN & "* Push Button (to alter rollover / mouseDown states)"
  6. end
  7.  
  8. on getBehaviorTooltip me
  9.   return "Use with graphic members." & RETURN & RETURN & "When you drop this behavior on a sprite, you can choose which marker in the current movie to jump to on mouseUp. " & "You can also choose to jump to the next or the previous marker." & RETURN & RETURN & "Use this behavior with the Jump Back Button to allow the user to return to visited sequences."
  10. end
  11.  
  12. on beginSprite me
  13.   resolve(me)
  14.   initialize(me)
  15. end
  16.  
  17. on mouseUp me
  18.   jump(me)
  19. end
  20.  
  21. on resolve me
  22.   case myMarker of
  23.     "next":
  24.       myMarker = #next
  25.     "loop":
  26.       myMarker = #loop
  27.     "previous":
  28.       myMarker = #previous
  29.   end case
  30. end
  31.  
  32. on initialize me
  33.   global gNavigationButtonList
  34.   if not getPos([#next, #previous, #loop], myMarker) then
  35.     theMarkerList = RETURN & the labelList
  36.     markerExists = offset(RETURN & myMarker & RETURN, theMarkerList)
  37.     if not markerExists then
  38.       ErrorAlert(me, #markerMissing, myMarker)
  39.     else
  40.       delete char 1 to markerExists of theMarkerList
  41.       if offset(RETURN & myMarker & RETURN, theMarkerList) then
  42.         ErrorAlert(me, #runtime_DuplicateMarkers, myMarker)
  43.       end if
  44.     end if
  45.   end if
  46.   if myReturn then
  47.     if voidp(gNavigationButtonList) then
  48.       gNavigationButtonList = [#stack: [], #forward: [], #index: []]
  49.     else
  50.       if gNavigationButtonList.ilk <> #propList then
  51.         ErrorAlert(me, #invalidGlobal, gNavigationButtonList)
  52.       else
  53.         if not gNavigationButtonList.findPos(#stack) then
  54.           ErrorAlert(me, #invalidGlobal, gNavigationButtonList)
  55.         else
  56.           if not gNavigationButtonList.findPos(#index) then
  57.             ErrorAlert(me, #invalidGlobal, gNavigationButtonList)
  58.           else
  59.             if not gNavigationButtonList.findPos(#forward) then
  60.               ErrorAlert(me, #invalidGlobal, gNavigationButtonList)
  61.             end if
  62.           end if
  63.         end if
  64.       end if
  65.     end if
  66.   end if
  67. end
  68.  
  69. on jump me
  70.   global gNavigationButtonList
  71.   case myMarker of
  72.     #previous:
  73.       targetIsNewMarker = marker(-(the maxinteger) / 2) <> marker(0)
  74.     #loop:
  75.       targetIsNewMarker = 0
  76.     #next:
  77.       targetIsNewMarker = marker(0) <> marker(the maxinteger / 2)
  78.     otherwise:
  79.       targetIsNewMarker = marker(0) <> marker(myMarker)
  80.   end case
  81.   if myReturn and targetIsNewMarker then
  82.     currentMarker = [#frame: marker(0), #movie: the movieName]
  83.     gNavigationButtonList.stack.append(currentMarker)
  84.     if not gNavigationButtonList.index.getPos(currentMarker) then
  85.       gNavigationButtonList.index.append(currentMarker)
  86.     end if
  87.     gNavigationButtonList.forward = []
  88.   end if
  89.   if myJumpMode = "Go to" then
  90.     case myMarker of
  91.       #previous:
  92.         go(#previous)
  93.       #loop:
  94.         go(#loop)
  95.       #next:
  96.         go(#next)
  97.       otherwise:
  98.         go(marker(myMarker))
  99.     end case
  100.   else
  101.     case myMarker of
  102.       #previous:
  103.         play frame marker(-1)
  104.       #loop:
  105.         play frame marker(0)
  106.       #next:
  107.         play frame marker(1)
  108.       otherwise:
  109.         play frame myMarker
  110.     end case
  111.   end if
  112. end
  113.  
  114. on substituteStrings me, parentString, childStringList
  115.   i = childStringList.count()
  116.   repeat while i
  117.     tempString = EMPTY
  118.     dummyString = childStringList.getPropAt(i)
  119.     replacement = childStringList[i]
  120.     lengthAdjust = dummyString.char.count - 1
  121.     repeat while 1
  122.       position = offset(dummyString, parentString)
  123.       if not position then
  124.         parentString = tempString & parentString
  125.         exit repeat
  126.         next repeat
  127.       end if
  128.       if position <> 1 then
  129.         tempString = tempString & parentString.char[1..position - 1]
  130.       end if
  131.       tempString = tempString & replacement
  132.       delete me.char[1..position + lengthAdjust]
  133.     end repeat
  134.     i = i - 1
  135.   end repeat
  136.   return parentString
  137. end
  138.  
  139. on ErrorAlert me, theError, data
  140.   behaviorName = string(me)
  141.   delete word 1 of behaviorName
  142.   delete char -30001 of behaviorName
  143.   delete char -30001 of behaviorName
  144.   case data.ilk of
  145.     #void:
  146.       data = "<void>"
  147.     #symbol:
  148.       data = "#" & data
  149.   end case
  150.   case theError of
  151.     #getPDL_DuplicateMarkers:
  152.       terror1 = "Two or more markers in this movie have the same name. " & " This could lead to " & RETURN & "confusion if you use this behavior to go to a named marker."
  153.       terror2 = "Duplicate marker(s) = ^0"
  154.       terror2 = substituteStrings(me, terror2, ["^0": data])
  155.       alert(terror1 & RETURN & RETURN & terror2)
  156.     #markerMissing:
  157.       if the runMode = "Author" then
  158.         terror1 = "BEHAVIOR ERROR: Frame ^0, Sprite ^1"
  159.         terror1 = substituteStrings(me, terror1, ["^0": the frame, "^1": the currentSpriteNum])
  160.         terror2 = "Behavior ^0"
  161.         terror2 = substituteStrings(me, terror2, ["^0": behaviorName])
  162.         terror3 = "The chosen marker no longer exists." & RETURN & "Choose a valid marker in the Behavior Parmeters dialog."
  163.         terror4 = "Current marker = ^0"
  164.         terror4 = substituteStrings(me, terror4, ["^0": data])
  165.         alert(terror1 & RETURN & RETURN & terror2 & RETURN & RETURN & terror3 & RETURN & RETURN & terror4)
  166.       end if
  167.       abort()
  168.     #runtime_DuplicateMarkers:
  169.       if the runMode = "Author" then
  170.         terror1 = "BEHAVIOR ERROR: Frame ^0, Sprite ^1"
  171.         terror1 = substituteStrings(me, terror1, ["^0": the frame, "^1": the currentSpriteNum])
  172.         terror2 = "Behavior ^0"
  173.         terror2 = substituteStrings(me, terror2, ["^0": behaviorName])
  174.         terror3 = "The chosen marker does not  have a unique name. " & " The playback head will jump to the first marker with this name:"
  175.         terror4 = "Duplicate marker name = ^0"
  176.         terror4 = substituteStrings(me, terror4, ["^0": data])
  177.         alert(terror1 & RETURN & RETURN & terror2 & RETURN & RETURN & terror3 & RETURN & RETURN & terror4)
  178.       end if
  179.     #invalidGlobal:
  180.       terror1 = "BEHAVIOR ERROR: Frame ^0, Sprite ^1"
  181.       terror1 = substituteStrings(me, terror1, ["^0": the frame, "^1": the currentSpriteNum])
  182.       terror2 = "Behavior ^0"
  183.       terror2 = substituteStrings(me, terror2, ["^0": behaviorName])
  184.       terror3 = "[#stack [...], #index: [...], #forward: [...]]"
  185.       terror4 = "Current value = ^0"
  186.       terror4 = substituteStrings(me, terror4, ["^0": data])
  187.       alert(terror1 & RETURN & RETURN & terror2 & RETURN & RETURN & terror3 & RETURN & RETURN & terror4)
  188.       halt()
  189.   end case
  190. end
  191.  
  192. on isOKToAttach me, aSpriteType, aSpriteNum
  193.   tisok = 0
  194.   if aSpriteType = #graphic then
  195.     tisok = 1
  196.   end if
  197.   return tisok
  198. end
  199.  
  200. on getPropertyDescriptionList me
  201.   currentMember = sprite(the currentSpriteNum).member
  202.   markersList = GetMarkers(me)
  203.   if markersList.count() = 2 then
  204.     ErrorAlert(me, #getPDL_DuplicateMarkers, markersList[2])
  205.   end if
  206.   tlabellist = []
  207.   tlabellist.add("next")
  208.   tlabellist.add("loop")
  209.   tlabellist.add("previous")
  210.   repeat with i = 1 to count(the markerlist)
  211.     tlabellist.add((the markerlist).getProp((the markerlist).getPropAt(i)))
  212.   end repeat
  213.   return [#myMarker: [#comment: "On mouseUp, jump to marker", #format: #string, #range: tlabellist, #default: "next"], #myJumpMode: [#comment: "Jump Mode", #format: #string, #range: ["Go to", "Play and Return"], #default: "Go to"], #myReturn: [#comment: "Remember current marker for Back button?", #format: #boolean, #default: 1]]
  214. end
  215.  
  216. on GetMarkers me
  217.   localMarkerList = []
  218.   duplicatesList = []
  219.   markerString = the labelList
  220.   delete char -30000 of markerString
  221.   markerCount = the number of lines in markerString
  222.   repeat with i = 1 to markerCount
  223.     theMarker = markerString.line[i]
  224.     if localMarkerList.getPos(theMarker) then
  225.       if not duplicatesList.getPos(theMarker) then
  226.         duplicatesList.append(theMarker)
  227.       end if
  228.       next repeat
  229.     end if
  230.     localMarkerList.append(theMarker)
  231.   end repeat
  232.   if duplicatesList.count() then
  233.     return [localMarkerList, duplicatesList]
  234.   else
  235.     return [localMarkerList]
  236.   end if
  237. end
  238.